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This manual contains introductory material about program- 
ming aspects of the 1BM System/3 5445 Disk Storage as the 
5445 relates to the IBM System/3 Model 15 and the IBM 
System/3 Model 10 Disk System. 


This manual is organized in four chapters. The first chapter 
includes a general description of the 5445, a statement of 
the system requirements, and some programming consider- 
ations. The second chapter is devoted to system support 
information concerning access methods, split cylinder capa- 
bility, OCL FILE statements, and system utility programs. 
The third chapter briefly describes the program products as 
they apply to the 5445. The fourth chapter discusses Sys- 
tem/3-System/360-System/370 compatibility. (Coding 
information and examples are not discussed in this manual.) 


Prerequisite Knowledge 

The reader should be familiar with related publications, basic 
programming concepts, and component operations of the 
System/3 Model 15 or Model 10 Disk System. 

Related Publications 


Additional information about the Mode! 10 Disk System may 
be found in the following publications: 


9 /BM System/3 Model 10 Components Reference Manual, 
GA21-9103 


© /BM System/3 Model 10 Disk System Control Program- 
ming Reference Manual, GC21-7512 


® /BM System/3 Model 10 Disk System Halt Guide, GC21- 
7540 


@ /BM System/3 Model 10 Disk System Control Program- 
ming Macros Reference Manual, GC21-7562 


@ /BM System/3 Disk System Introduction, GC21-7510 


Additional information about the Model 15 may be found 
in the following publications: 


® /BM System/3 Model 15 Components Reference Manual, 
GA21-9193 


Preface 


© /BM System/3 Model 15 System Control Programming 
Reference Manual, GC21-5077 


© /BM System/3 Model 15 System Messages, GC21-5076 


o /BM System/3 Model 15 System Control Programming 
Macros Reference Manual, GC21-7608 , 


© /BM System/3 Model 15 Introduction, GC21-5094 


The following publications contain information about both 
Model 10 Disk System and the Model 15: 


© /BM System/3 Disk Concepts and Planning Guide, GC21- 
7571 


© /BM System/3 RPG I! Reference Manual, SC21-7504 


© /BM System/3 Subset American National Standard 
COBOL Reference Manual, SC28-6452 


© /BM System/3 FORTRAN IV Reference Manual, GC28- 
6874 


© /BM System/3 Basic Assembler Reference Manual, SC21- 
7509 


© /BM System/3 Disk Sort Reference Manual, SC21-7522 
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The 1BM 5445 Disk Storage offers more file capacity and 
greater performance than the IBM 5444. You can attach up» 
to two 5445 units to the System/3 Model 10 Disk System 
and up to four units to the System/3 Model 15. Because the 
programming support for this storage is patterned after that 
for the 5444 Disk Storage Drive, the programming necessary 
to implement the device into an existing system is reduced. 


GENERAL DESCRIPTION 


The 1BM 5445 Disk Storage provides large capacity direct 
access storage—up to 40.96 million bytes for the Model 10 
Disk System, and up to 81.92 million bytes for the Model 
15. The 5445 uses removable disk packs which are organized 
by tracks, cylinders, and sectors. 


A track consists of a band of information on a single disk 
surface. A cylinder is formed by relating all of the corre- 
sponding tracks on the disk surfaces of a disk pack. (The 
same cylinder address is used for all corresponding tracks on 
the disk.) Each track is divided into 20 sectors (records) 
which have individual sector addresses. The 5445 is used 
only for data storage. No libraries can reside on the 5445. 


SYSTEM REQUIREMENTS 

The IBM 5445 Disk Storage is designed to operate with the 
standard System/3 Model 10 Disk System and Model 15 
minimum configurations. 

The Model 10 configuration is: 

®@ 5410 Processing Unit Model A13 (12K) 

© 5203 Printer Model 1 or 1403 Printer Model 2 

© 5444 Disk Storage Drive Model 1 

@ 5424 Multi-Function Card Unit Model A1 

For a description of these units or information concerning 
the operation and characteristics of the System/3 Model! 10 


Disk System, refer to /BM System/3 Model 10 Components 
Reference Manual, GA21-9103 
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The Model 15 configuration is: 
© 5415 Processing Unit Model A17 (48K) 


@ 3277 Display Station Model 1 with Operator Console 
Keyboard Feature (4632) 


@ 5444 Disk Storage Drive Model A2 
@ 1403 Printer Model 5 or 2 or N1 
© One of the following: 


5424 Multi-Function Card Unit Model Al or A2 
2560 Multi-Function Card Machine Model A1 or A2 
1442 Card Read Punch Model 6 or 7 


For a description of these units or information concerning 
the operation and characteristics of the System/3 Model 15, 
refer to /BM System/3 Model 15 Components Reference 
Manual, GA21-9193. 


PROGRAMMING CONSIDERATIONS AND ATTRAC- 
TIONS 


Model 10 Disk System Considerations 


If the 5445 is attached to the Model 10 Disk System, you 
can store up to 40.96 million bytes on two online disk packs. 
The 60 millisecond average access time enables processing 

of message data that exceeds the present 5444 Disk Storage 
Drive data transfer rate. Adding another disk storage drive 
allows combining of multivolume files to gain better through- 
put. Up to 50 files can be contained on each 5445 disk pack. 


System/3 Model 10 disk programming has been modified to 
support up to two 5445 drives on a System/3 Model 10 and 
up to two 5444s. The minimum CPU size is 12K bytes; if 
the dual programming feature (DPF) is used, a minimum of 
16K bytes is required. Either disk drive can be identified 
through OCL (operation control language) statements at 


either Gisk Orive can be identi —— 
program run time. Either or both drives can be addressed by 


iene —— 
both program levels, when operating in a dual programming 
ype SASS 


environment. 


eee 
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Model 15 Considerations 


If the 5445 is attached to the Model 15, you can store up to 
81.92 million bytes on four online disk packs. Spooling 
support on the Model 15 requires a 5445 disk. 


The programming support for the 5445 on the Model 15 is 
included in the basic support for the system; the Model 15 
support of the 5445 is identical to that provided by the 
Model 10, unless indicated otherwise. The basic SCP (Sys- 
tem Control Program) can support one, two, three, or four 
5445 drives on a Model 15 with one or two 5444s. The 
minimum CPU size is 48K bytes. Like the Mode! 10 Disk 
System drives, Model 15 disk drives can be identified through 
OCL statements at program run time and can be addressed 
by either partition of the multiprogramming system. 


Utility Programs 


Utility programs are available for 5445 disk and data file 
maintenance. The utility programs provided for the 5445 are 
parallel to the utilities for the 5444 Disk Storage Drive, 
except that libraries are not supported on the 5445. Chap- 
ter 2 of this manual describes the functions and specifications 
for the utility programs. For additional information and 
examples of the utility programs, see the /BM System/3 
Model 10 Disk System Control Programming Reference 
Manual, GC21-7512, or the /BM System/3 Model 15 System 
Control Programming Reference Manual, GC21-5077. 


Split Cylinders 


By using split cylinders, you can arrange more than one data 
file, of either direct or sequential file organization, on one 
or more cylinders, with each of the files occupying a corre- 
sponding part of each cylinder. A split cylinder file can 
occupy up to 19 tracks per cylinder. Therefore, you can 
arrange files in combinations to decrease the access time 
required. 


RPG I} Feature (Model 10 Only) 


The Disk RPG II 5445 Disk Storage feature (a program prod- 
uct feature} makes possible the processing of data files 
located on the 5445. This feature is used with the Model 10 
only; 5445 support is standard on the Model 15. Additional 
information about RPG II is provided in Chapter 3. 


Disk Sort Feature (Model 10 Only) 


The IBM System/3 Disk Sort 5445 Disk Storage feature (a 
program product feature) provides all the functions of the 
5444 Disk Sort program. This feature sorts all single or 
multivolume disk files. Two types of files created by the 
Disk Sort program are: 


© Sequential files — 
® Record address files 


This feature is used on the Model 10 only; 5445 support is 
standard on the Model 15. 


Additional information about Disk Sort is provided in 
Chapter 3 or in the /BM System/3 Disk Sort Reference 
Manual, $C21-7522. 
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The programming support available for the 5445 provides 
data storage and data retrieval. Up to two drives are sup- 
ported on the Model 10; up to four drives are supported 
on the Model 15. 


You can reference the 5445 through OCL statements at 
execution time. When operating in a dual programming 
environment on the Mode! 10, either or both drives can be 
addressed by both program levels. However, the same file 
cannot be addressed by both program levels at the same 
time unless: 


@ Both program levels are using it as input only 


@ One program level is using it as input and the other is 
using it as update 


The same applies to accessing the 5445s on the Model 15 
from both partitions. 


ACCESS METHODS SUPPORTED 


The System/3 disk system management routines support 
three types of file organizations: 


@ Sequential 
© Indexed 
© Direct 


Figure 1 shows the file organizations and the access methods 
supported. Except as noted, these access methods apply to 
both single and multivolume files for Model 10 and Model 
15. They are supported in a manner consistent with the 
5444. Shared input/output methods are not supported for 
the 5445 files. 
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Access Methods File Organization 


Sequential |Indexed | Direct | 


X 
X 
X 
X 
X 
X 
X 
X 
Xx 
X 
X 


Figure 1. File Organizations and Access Methods Supported for the 
IBM 5445 Disk Storage 
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1 Access method does not apply for 
multivolume files on the Model 10. 
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SPLIT CYLINDER SUPPORT 


By using split cylinders, you can allocate partial cylinders 
for a data file. For example you may allocate File A, the 
master file, on tracks 0-3 of cylinders 3-5 (Figure 2). File 
B resides on tracks 4-7 .of the same cylinders. The remain- 
ing tracks are reserved for files associated with the master 
file. The following information is specified in the FILE 
statement for split cylinder files: 


@ The beginning cylinder 
@ The number of tracks to be allocated per cylinder 
@ The total number of cylinders to be allocated 


When using split cylinders, you can specify as many as 19 
tracks per cylinder for a data file. 


Tracks in 
a Cylinder 


Figure 2. Track Allocation for Split Cylinder Files 





Split cylinder is supported only for sequential and direct 
file organizations and their associated access methods. It 
is not available for either multivolume files or indexed file 
organizations. 


The first file created in a set of split cylinder files is the 
master file. It must begin with the first track of the cylinder. 
When split cylinder files of the same set are allocated in 
different jobs, the master file must be allocated in the first 
job. 


The SPLIT parameter, a keyword parameter for the OCL 
FILE statement that is used when creating split cylinders, 
is discussed later in this chapter. 


File A ‘Master File’ 
Tracks 0-3 Cylinder 3-5 


~) File B 
Tracks 4-7 Cylinder 3-5 


L_ Cylinders 3-5 


if 
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OCL FILE STATEMENT 


The OCL FILE statement provides information about disk 
files. Disk system management uses this information to 
read and write disk records for your programs. A FILE 
statement must be provided for each disk file used by your 
programs. This statement is the same statement that is used 
for the 5444. It must be contained within the set of OCL 
statements for each program using the 5445. 


The keywords provided for the 5445 are summarized in 
Figure 3. These keyword parameters are permitted on the 
FILE statement in the description of 5445 files. Note that 

a blank in the right-hand column of the figure indicates no 
change in the function of the keyword parameters for the 
5445. The following sections provide additional information 
about the keyword parameters. 


Keyword Parameters for Single Volume Files 


NAME: This parameter is required for the FILE statement. 
It gives disk system management the name that your pro- 
gram uses to refer to the file. The parameter must begin 
with one of the 29 alphabetic characters and may be fol- 
lowed by up to seven characters, not including the quote, 
comma, and blank. 


PACK: This parameter is also required for the FILE state- 
ment. It tells disk system management the name of the 
disk pack that contains the file. The management routines 
check this name to ensure that it is the same as the name of 
the disk pack in the volume label of the pack being used. 
The parameter may consist of from one to six characters, 
not including the quote, comma, and blank. 


UNIT: This parameter is the last parameter required for the 
FILE statement. It supplies the location of the disk pack 
that contains the file being referenced. Four possible codes 
indicate the location of the 5445 disk pack: 


Code Meaning 

D1 5445 Drive one 

D2 5445 Drive two 

D3 5445 Drive three (Model 15 only) 
D4 5445 Drive four (Model 15 only) 


LABEL: This parameter refers to the filename which iden- 
tifies the file in the VTOC (volume table of contents) on 
disk. This parameter is required only if the filename ina 
program differs from the filename on disk. Ifa new file is 
being created and the LABEL parameter is omitted, the 
filename from the NAME parameter is used. 


DATE: This parameter is required when two or more files 
having the same name exist on a disk volume and a particu- 
lar file is desired. The creation date of the desired file is 
coded in the DATE parameter. If two or more files with 
the same name exist on a disk volume and neither the date 
nor the location is given, the file having the latest creation 
date is selected. The date must be in the form (month-day- 
year or day-month-year) specified at system generation time. 
The date must be written as three two digit fields without 
punctuation, or three fields of one or two digits separated 
by punctuation. Any characters except numbers, quotes, 
commas, or blanks may be used as punctuation. 


RETAIN: This parameter is optional and indicates the classi- 
fication the file was given when it was created. The classi- 
fications are: 


Code Meaning 

Ss Scratch file 

T Temporary file 

P Permanent file 

A Reactivate scratch file (Model 10 only) 


The file is assumed to be temporary if this parameter was 
omitted at file creation time. 


If a file was created on the Model 10 as temporary or per- 
manent but subsequently was changed to scratch by a new 
RETAIN parameter or the File Delete program, it can be 
accessed by using a retain code of A. A scratch file accessed 
in this way (RETAIN-A) will have its retain code changed to 
T by the system control program. Scratch files on the 
Model 15 are used only for the duration of one program; 
therefore, RETAIN-A is not supported. 
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KEYWORD | PARAMETER List of Parameters Required | Required Description of Function Provided for 5445 
for Multivolume Files or Optional (Blank Indicates No Change for 5445) 


filename Required 


name Required 

Required The codes D1 and D2 indicate the drive 
location of the disk pack for Model 10; 
the codes D1, D2, D3, and D4 indicate 
the drive location for Model 15 


code 


LABEL filename Optional 


DATE date Optional 


RETAIN . | code Optional 


“ | 
oe | & 


< 
o 


RECORDS | number Required Required except for split cylinder files; 
or for crea- cannot be used with split cylinder files 
TRACKS ting files 


LOCATION | cylinder number Optional 
cylinder number/ Optional 
track number 
filename Required Required for split cylinder files other 
Must be used with single than the master file 
volume files only 
SPLIT tracks/cylinders No Required | Used with the first set of a file to be 
Must be used with single only for allocated 
volume files only creating 
split cyl- 
inder files 
No Required Used for succeeding files of the set 
Must be used with single only for 
volume files only creating 
split cyl- 
inder files 
HIKEY highest allowed Required 
key fields only for 
loading or 
adding to 
an indexed 
-multi- 
volume file 


Figure 3. Description of the Parameters on the OCL FILE Statement for the IBM 5445 Disk Storage 
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RECORDS or TRACKS: One, but not both, of these param- 
eters may appear in the FILE statement; one of them must 
appear for files being created. These parameters are not 
used for split cylinder files. They indicate the amount of 
disk space necessary for the file. If the file is being referenced, 
these parameters inform disk system management of the 
amount of space that was used for the file when it was 
created. The space requirement is specified as the number 
of records in the file (RECORDS) or as the number of disk 
tracks required (TRACKS). Two restrictions are applicable 
when defining the space requirement: 


© If RECORDS is used, the number may be up to six digits 
long. 


© If TRACKS is used, the number must be within the range 
1 to 3980. 


The RECORDS or TRACKS keyword parameters must not 
be used with split cylinder files. 


LOCATION: This parameter is used to specify the cylinder 
and track on which the file is to start. This keyword param- 
eter is optional. It may be used to specify the: 


© Cylinder number 
@ Cylinder number/track number 
@ Filename 


The filename entry is required for creating split cylinder 
files other than the master split cylinder file. The filename 
specified must be the name of the master file. 


When you are accessing an existing file, the LOCATION 
keyword parameter must be identical to that used in creat- 
ing the file. When you are creating a file, this parameter 
specifies the beginning position of the file. 


When two or more files on a disk pack have the same file- 
name, this keyword parameter can be used to identify the 
desired file. 


The following restrictions apply when using the LOCATION 
keyword parameter: 


@ Cylinder 0 cannot be used; it is reserved for system use. 


®@ The cylinder number specified must be between 1 and 
199. 


@ The track number specified must be between O and 19. 


© The track number must be 0 when this entry is used for 
the master split cylinder file. 


® The cylinder number and track number, when specified 
together, must be separated by a slash. 


SPLIT: This parameter is used only for the IBM 5445 Disk 
Storage. It is required for, and must be used only for, creat- 
ing split cylinder files. The two parameters for this keyword 
are: 


© Tracks/cylinders 
© Tracks 


The tracks/cylinders form of the SPLIT keyword param- 
eter is specified when allocating the first of a set of files 
(master file). Tracks indicates the number of tracks per 
cylinder to be reserved for the first or master file. Cylinders 
indicates the number of cylinders necessary for the complete 
set of split cylinder files. By specifying SPLIT, you can 

use fewer than the maximum number of tracks on a cylin- 
der for as many cylinders as you need for a particular file. 


The tracks form of the SPLIT keyword parameter is speci- 
fied for all succeeding files of the set of split cylinder files. 
The number of tracks specified indicates the number of 
tracks per cylinder to be reserved for the particular file. 


Both the tracks/cylinders and tracks parameter formats 
require that the tracks and block length specified must be 
a value such that the first block is completely contained in 
the first cylinder. 
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These restrictions apply to the use of this keyword param- 
eter: 


@ The SPLIT keyword must not appear in a FILE statement 
that has a RECORDS or TRACKS keyword parameter. 


@ The SPLIT keyword must not be used with multivolume 
or indexed files. 


@ The number of tracks specified must be from 1 through 
19 and must not cause allocation beyond the last cylin- 
der specified. 


@ The number of cylinders specified may be from 1 
through 199. 


® The total number of tracks specified per cylinder for a 
set of split cylinder files must not exceed 20. 


© The tracks/cylinders form of the parameter must be 
separated by a slash. 


Keyword Parameters for Multivolume Files 


Files which exceed the capacity of one disk pack can be 
continued on one or more subsequent packs. Such files 

are known as multivolume files. 5445 multivolume file 
support requires that the entire file reside on 5445 disk 
packs. Files space on offline packs can be allocated for 
muiltivolume files (other than the initial volume) under 

two conditions: 


@ The packs are empty. 


© TRACKS and LOCATION are specified and the TRACKS 
and LOCATION parameters for the offline packs de- 
scribe available space. 


The keyword parameters that require lists for multivolume 
files are: PACK, UNIT, TRACKS, RECORDS, LOCATION, 
and HIKEY. These parameters require lists to describe all 
of the packs containing the file. Certain rules must be 
followed when indicating the lists for these parameters: 


@ The lists must be enclosed in quotes. 

@ The items in the list must be separated by commas. 

@ The lists, except for HIKEY, must not contain blanks. 
The functions of the keyword parameters have been 
explained (except the HIKEY parameter which is explained 


here); therefore, only the considerations for using the lists 
in these parameters are explained here. 


PACK: The list for this parameter contains the names of 
the volumes in the order they are to be used. 


UNIT: The list for this parameter may contain a maximum 
of two unit codes for 5445 files on the Model 10 and four 
unit codes for 5445 files on the Model 15. If two or more 
unit codes are given, the volumes must be mounted in the 
order indicated by the unit codes. If all the volumes are 

to be mounted on the same drive, only one unit code is 
given. 


TRACKS or RECORDS: The list for these parameters 
indicates the amount of space occupied by the multivolume 
file. The numbers in the list must correspond to the order 
of the names listed in the PACK parameter. 


LOCATION: The list for this parameter contains the cylin- 
der number or cylinder number/track number parameter - 
for the disk you use for the file. The parameters must 
correspond to the order of the names in the PACK param- 
eter. If LOCATION is specified for one volume of a multi- 
volume file, it must be specified for all the volumes of that 
file. 


HIKEY: The HIKEY parameter is used only for multi- 
volume indexed files. HIKEY limits the highest key field 
that can be put on each pack of a multivolume file. For 
example, in the following HIKEY parameter, three volumes 
are used: HIKEY-’JONES,NICOL,ZZZ2ZZ’. The highest 
key field allowed on the first volume is JONES. This means 
that all the records beginning with A and including JONES 
will be on this volume. Since HIKEY parameters must be 
in ascending order, the next volume contains all of the 
records with keys following JONES and including NICOL. 
The last volume contains all the records with names that 
come after NICOL. 


UTILITY PROGRAMS 


Various utility programs are included with disk system 
management. These utility programs, resident on the 
5444, perform a variety of functions, including preparing 
disks for use in reorganizing an indexed file or deleting 
files. Each of these programs is described separately in 
this section, following information on utility program 
halts and OCL statements. 


Program Halts 


On the Model 10 Disk System, utility program halts and 
messages are indicated by the message display unit and the 
system log device as described in the /BM System/3 Model 
10 Disk System Halt Guide, GC21-7540. 


On the Model 15, the CRT (cathode ray tube) indicates 
the messages for the utility programs as described in the 
IBM SYSTEM/3 Model 15 System Messages, GC21-5076. 


OCL Statements 


Each utility program requires a set of OCL statements. The 
first statement required within a set of OCL statements is 
the LOAD statement. It identifies the program to be run 
and indicates the disk from which the program will be 
loaded. The statement format used when loading a pro- 
gram from disk is: 


// LOAD program name,unit 





The program name in the LOAD statement specifies the 
utility program you want to run. The following list con- 
tains the utility programs described in this section and the 
name that must appear in the LOAD statement. 


Program Name 


Disk Initialization SINIT 
Alternate Track Assignment SALT 
Alternate Track Rebuild $BUILD 
File and Volume Label Display $LABEL 
File Delete $DELET 
Copy/Dump $COPY 
Dump/Restore $DCOPY 


The unit parameter specifies a code that describes the loca- 


tion of the system pack which contains the utility program. 


The codes are: 


Code Meaning 

R1 Removable disk on 5444 drive 1 
F1 Fixed disk on 5444 drive 1 

R2 Removable disk on 5444 drive 2 
F2 Fixed disk on 5444 drive 2 





Another statement that is required for each utility program 
is the RUN statement. The format of this statement is: 


//RUN 
The program begins after the system reads this statement. 


END Statement 


The final statement required for each utility program is the 
END statement. The format of the statement is: 


// END 


This statement requires no parameters and is the last state- 
ment required for a program. 


Utility Control Statement Formats 


The formats of utility control statements are illustrated 
using the conventions explained in Figure 4. 


[ Optional ] 


Choose 
//FUNCTION KEYWORD-PARAMETER, One of 
These 


[Assumed | 


KEYWORD-PARAMETER entries can appear in any order. 


BRACES { } indicate a choice of entries. 


BRACKETS [ ] _ indicate an optional entry. 


UNDERSCORE in an optional entry means that the underscored 
value is assumed if the entry is not present in 
the statement. 


HYPHENS separate keywords and parameters. 
COMMAS separate all entries. 


SPECIAL CHARACTERS such as // must appear as they are 
shown in the statement format. 


WORDS OR ABBREVIATIONS IN CAPITAL LETTERS, such as 
UIN and ALT, must appear as shown in the 
statement format. 


SMALL LETTERS, such as yyy and mn, represent numbers or 
other information you must supply. The number 
of letters indicates the number of characters in the 
information or the number of digits in the numbers. 
Three dots, as in x... x, indicates that the number 
of characters or digits may vary. 


Figure 4. Conventions Utilized for Illustrating Statement Formats 
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Program Descriptions 


The following utility program descriptions contain informa- 


The control statements required for this utility program to 
initialize a disk pack are shown in Figure 5. The,following 
numbered list corresponds to the numbered items in the 


tion about functions of the utility programs which are figure. 
applicable to the 5445 and the specifications required to use 
the programs. Examples of coding are not given in this 1. | The UNIT keyword parameter specifies the location 


manual. 


The following utility programs are also described in the 
IBM System/3 Model 10 Disk System Control Programming 
Reference Manual, GC21-7512, and /BM System/3 Model 15 


System Control Programming Reference Manual, GC21-5077. 


of the disk pack you want to initialize. Any combin- 
ation of a maximum of five drives may be specified 
for the Model 10 and seven drives may be specified 
for the Model 15. 


The codes indicate the locations of the disk packs: 


Code Meaning 
Disk Initialization Program 

R1 Removable disk on 5444 drive 1 
All disk packs used by programs processed under disk sys- F1 Fixed disk on 5444 drive 1 
tem management must be initialized. The Disk Initialization R2 ~~—~—«~Removable disk on 5444 drive 2 - 
program has the capacity to initialize packs on both 5444 F2 Fixed disk on 5444 drive 2 
and 5445 disk drives. D1 5445 drive 1 

D2 5445 drive 2 
The following functions are provided by this utility pro- D3 5445 drive 3 (Model 15 only) 
gram: ; 


1. Performs a complete surface analysis of the pack to 
determine if the pack is usable and whether it con- 
tains any defective tracks 


2. Assigns alternate tracks for defective tracks when 
the pack is usable 


3; Initializes the volume label in cylinder 0, track 0, 
record 3 


4. Initializes the System/360 VTOC in cylinder 0 


5. Initializes all other tracks to 256 byte records 


// LOAD SINIT, 


// RUN 
PRIMARY 


D4 5445 drive 4 (Model 15 only) 


The TYPE keyword parameter specifies the type of 
initialization performed. The optional parameters are: 


PRIMARY—The disk pack will be initialized only if 
there are no active files on the pack. 


SECONDARY—Used with 5444 only. 


CLEAR—The disk pack is initialized without check- 
ing for active files. 


® 


SECONDARY 
CLEAR 


ena as \ i. \] [ VERIFY—nnn | 


Note: One VOL statement for each unit specified in 
the UNIT parameter of the UIN statement. 


//UIN UNIT— {mm \ TYPE 


mn,...,mn 


//VOL PACK-xxxx — [ ,ID-x...x ] [ NAMES60-x...x ] 





Figure 5. Specifications Required for the Disk Initialization Program 


10 


Se ae 


The optional ERASE keyword parameter applies to 
disk packs that have already been initialized. It tests 
for defective tracks. When the NO option is specified, 
all tracks except the defective tracks are retested. 
When the YES option is specified, all tracks, includ- 
ing defective tracks, are retested. If this parameter is 


omitted from the statement, the NO option is assumed. 


The VERIFY parameter is optional. It indicates the 
number of times (from 1 to 255) the program will 
perform surface analysis before determining the valid- 
ity of atrack. Tracks that cause errors any time dur- 
ing the test are considered defective and will have 
alternate tracks assigned to them. The testis per- 
formed once if the parameter is omitted from the 
statement. 


The PACK keyword parameter entry on the VOL 
statement provides a pack name of up to six charac- 
ters which is placed in the volume label. 


The optional 1D entry further identifies the disk pack. 
It is used as additional identification of the disk. The 
identification consists of up to ten characters that, 

if specified, are placed in the volume label. 


The optional NAME360 parameter provides a file- 
name which is placed in the System/360 Data Set 
Control Bicok (DSCB). If this parameter is not used, 
the default name SYSTEM/3.DATA is used. 


The name you provide must conform to the OS/360 
naming conventions. The filename may consist of 
one name or a series of names separated by periods. 
The first character must be alphabetic and the name 
may be from one to eight alphameric characters long, 
excluding the dash (—), asterisk (*), quote (‘), or 
period (.). . 


The special character period (.) separates a series of 
names in a filename. The length of the filename 
must not exceed 44 characters including all names 
and periods. 


Alternate Track Assignment Program 


An alternate track is a substitute track selected to accept 
the contents of a defective track. Sixty alternate tracks 
are available on the 5445 disk packs. The Alternate Track 
Assignment program can replace the contents of any track 
except tracks 0, 1, or an alternate track. Thereafter, any- 
time a program attempts to use a track that has been as- 
signed an alternate, the alternate will be used automatically 
instead. 


The three conditions for using this program depend on the 
function to be performed. 


© Conditional assignment 
© Unconditional assignment 
© Unconditional release 


The conditions are described through parameters on the 
utility control statement. 


The conditional assignment tests tracks suspected of causing 
errors. If the track is defective, an alternate track is assigned. 
The unconditional assignment assigns alternates for a speci- 
fied number of tracks, whether they are defective or not. 
Unconditional release frees an alternate track making it 
available for future use. 


When programs encounter reading or writing errors, the 
system automatically halts the current operation. Some of 
the data might not be recovered when the Alternate Track 
Assignment program is used. If the data cannot be recovered 
without an error condition, the record or records are read 
under reduced hardware checking conditions and are written 
on the alternate track. The record or records that contain 
the error are printed in a form that completely identifies 

the data written on the alternate tracks. This printout 
should be retained. It is required for running the Alternate 
Track Rebuild program. 
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The control statements required for the Alternate Track 
Assignment program are shown in Figure 6. The following 
numbered list corresponds to the numbered items in the 
figure. 


1. The ALT statement is required for each disk pack 
processed during the current run. There may be a 
maximum of six ALT statements. 


2. The PACK parameter identifies the disk pack contain- 
ing the defective tracks. The name used is the name 
assigned by the Disk Initialization program. This 
disk pack must be online when the Alternate Track 
Assignment program is run. 


3. The UNIT parameter indicates the location of the 
disk pack containing the defective track. The D1, 
D2, D3, and D4 unit codes apply to the IBM 5445 
Disk Storage drive. 


4. |The VERIFY parameter is optional and specifies the 
number of times surface analysis is to be performed 
on a suspected defective track. The number specified 
may be from 1 to 255, or the parameter may be 
omitted and surface analysis will be performed once. 


If this parameter is used along with the ASSIGN or 
UNASSIGN parameter, it affects only the conditional 
assignment of defective tracks, those tracks not speci- 
fied by the ASSIGN or UNASSIGN parameters. 
Conditional assignment is performed after any forced 
assignments. ; 


// LOAD SALT, 


// RUN 


QO ® ® 


// ALT PACK-x...x,UNIT — [,VERIFY-nnn] 





5. | The ASSIGN parameter applies to unconditional assign- 
ment of alternate tracks. It indicates which tracks Z 
should be assigned alternate tracks. A list of up to 
six track numbers may follow the parameter; each 
track listed is assigned an alternate track. 


6. |The UNASSIGN parameter applies to the uncondi- 
tional release of alternate tracks. The program cancels 
the assignment of the alternate tracks that are listed 
on the parameter. A maximum of six assignments 
may be canceled. 


Alternate Track Rebuild Program 


The Alternate Track Rebuild program allows you to correct 
data that could not be transferred correctly to an alternate 
track. The information received from the Alternate Track 
Assignment program gives the name of the disk and the 
numbers of the track and sectors suspected of containing 
incorrect data and is used for writing contro! statements for 
this program. A number of alternate tracks may be corrected 
during one program run. Wher correcting alternate tracks, 
be sure that the defective track has been assigned an alter- 
nate before modifying the data on that track. The program 
reads each set of statements and moves the corrected data 
into its proper location within a sector. Remember, these 
corrections are actually made on an alternate track. 


AN ait 


UNASSIGN —{*tt 


geee 


Figure 6. Specifications Required for the Alternate Track Assignment Program 
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The control statements required for this utility program to 
build alternate tracks are shown in Figure 7. The following 
numbered list corresponds to the numbered items in the 
figure. 


1. The REBUILD statement specifies: 


© The name and location of the disk pack being 
corrected. 


® The original track and sector address where the 
correction is to be made. 


© The location and number of characters to be 
replaced in the sector. 


This control statement is required for each sector 
being changed and must be followed by one or more 
data statements. 


2. The PACK parameter indicates the name of the disk 
pack that contains the alternate track being modified. 
This is the name assigned to the pack by the Disk 
Initialization program. 


3. The UNIT parameter indicates the drive on which the 
disk pack, specified by the PACK parameter, will be 
mounted. The D1, D2, D3, and D4 unit codes indicate 
the IBM 5445 Disk Storage drive. 


4. The TRACK parameter refers to the defective track 
and sector that contains the data being corrected. 
Six characters refer to this location, the first four 
_ characters identify the track number and the last 
two characters identify the record number. 


// LOAD $BUILD, 


// RUN 


@ Q@ © @ 


5. 


The LENGTH parameter indicates the number of 
characters that must be modified in the specified 
record. The length specified must be in multiples of 

2 and can range from 2 through 256, the maximum 
capacity of a sector. The length applies to characters 
that occupy consecutive positions in the sector. If 

the characters occupy nonconsecutive positions, either 
replace all intervening characters or use more than one 
REBUILD statement. 


The DISP parameter indicates the position in the 
sector of the first byte of data being replaced. Start- 
ing at the position indicated, the program replaces 
the number of characters specified in the LENGTH 
parameter. The position of the first character is 1, 
the position of the second is 2; and so forth. The 
maximum DISP specification is 255. When the modi- 
fied record uses a key, the key is considered part of 
the data area in calculating the displacement. 


The data statements contain the information to be 
placed on the specified record. Replacement characters 
are entered on the data statements in hexadecimal form. 
The disk records are updated, two bytes at a time, by 
the pairs of hexadecimal characters. Pairs of characters 
on the data statements must be separated by commas. 
When more than one statement is used, the last entry 
on all except the last data statement, must be a comma. 
The first blank entry indicates the last entry for all 

data statements. A maximum of 127 data statements 
can be entered with one program run. 


@ © 


// REBUILD PACK-x...x, UNIT — TRACK-ttttss, LENGTH-nnn,DISP-nnn 


@ 


data statement(s) 


// END 





Figure 7. Specifications Required for the Alternate Track Rebuild Program 
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File and Volume Label Display Program 


The File and Volume Label Display program can be used to 
print specific file information in readable format. This 
utility program performs the following functions: 


® Displays the VTOC information for any specified file- 
name on a given disk pack. 


© Displays the VTOC information for all files in the VTOC. 

© Displays the status of the disk pack on any specified unit 
including the number of available alternate tracks and the 
size and location of available space on the pack. 

© Displays a message when the track usage information for 


the pack does not match the track usage indicated by 
VTOC entries (Model 15 only). 


// LOAD $LABEL, 


The control statements required for this utility program 
are shown in Figure 8. The following numbered list corres- 
ponds to the numbered items in the figure. 


1. The DISPLAY statement is required. 


2; The UNIT parameter specifies the drive which contains 
the disk pack containing the volume information to 
be printed. The D1, D2, D3, and D4 unit codes are 
used to specify the 5445. 


S; The LABEL parameter indicates the information to 
be printed from the specified unit. If VTOC is speci- 
fied on this parameter, all the volume information is 
printed. The meaning of the VTOC contents is ex- 
plained in the /BM System/3 Model 10 Disk System 
Control Programming Reference Manual, GC21-7512, 
and the /BM System/3 Model 15 System Control 
Programming Reference Manual, GC21-5077. The 
VTOC is counted as one filename. 


If a filename or several filenames are specified for 

this parameter, only the VTOC information for the 
specified files is printed. A maximum of 20 filenames 
may be listed for one program run. 


(2) vToc 
// DISPLAY UNIT - filename 
‘filename,...’ 





Figure 8. Specifications Required for the File and Volume Label! Display Program 
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File Delete Program 


The File Delete program frees space on disk packs, making 
it available for other files. Space can also be made available 
by changing the OCL retain attributes to S (scratch) when 
using the file. 


This program frees space for a single file or for all files on 


a disk pack by removing the files from the System/3 VTOC. 


The contents of the files are then unrecoverable. 


The control statements required for this utility program 
are shown in Figure 9. The following numbered list cor- 
responds to the numbered items in the figure. . 


1. Either the SCRATCH or REMOVE statement must 
be specified depending on the operation to be per- 
formed. The SCRATCH statement specifies a file 
whose retain code is changed to S (scratch). On the 
Model 10, the entry remains in the System/3 VTOC 
although the space on the pack is considered available 
for other files. On the Model 15, the SCRATCH 
statement is treated as a REMOVE statement. The 
REMOVE statement adds space to the existing avail- 
able space on the pack and removes the file entry 
from the System/3 VTOC. 


2. The PACK parameter indicates the name of the disk 
pack that contains the file being deleted. This is the 


name assigned to the pack by the Disk Initialization 
program. 


// LOAD $DELET, 


QO . @ @ ® 


The UNIT parameter indicates the drive on which the 
disk pack, specified in the PACK parameter, is 
mounted. The D1, D2, D3, and D4 unit codes specify 
the 5445 drives. 


The LABEL parameter identifies the files to be 
deleted and is expressed by one of three parameters. 
VTOC indicates that all files on the volume are to be 
deleted. Filename indicates that only the specified 
file is to be deleted. More than one filename may be 
specified if multiple files are to be deleted. A maxi- 
mum of 50 files may be deleted during one run. 


The DATE parameter identifies a particular file to be 
deleted when more than one file of the same name is 
specified on the LABEL parameter. If the DATE 
parameter is omitted and there are several files with 
the same name, all of the files are deleted. 


The DATA parameter may be used only with the 
REMOVE control statement. If the YES option is 
selected, the data is removed from the file. If the NO 
option is selected, or if the parameter is omitted, the 
data is not removed from the file. 


The FORMAT statement (Model 15 only) is used 
when a system failure or an inadvertent re-IPL may 
have left space allocated, but not utilized, on the 
disk. The FORMAT statement frees this allocated 
space. 


@® 


® 
poate | 


HV SCRATCH \ PACK-x... x, UNIT— ,LABEL— VTOC 
REMOVE filename 


[,DATE—nnnnnn] 
‘filename, ...’ 


// FORMAT UNIT— Note: The FORMAT statement is 


supported for the Model 15 only. 





Figure 9. Specifications Required for the File Delete Program 
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Copy/Dump Program 2. 


The functions that the Copy/Dump program performs 

for the 5445 are similar to the functions it performs for 

the 5444. However, when using 5445 drives on your 
system, a pack cannot be copied from a pack on one drive 

to another pack on the same drive. The functions performed 
by the program are: 


@ Copy an entire pack to another pack of the same type 


@ Copy a data file to another pack or to another location 
on the same pack 


© Copy and reorganize an indexed file 4. 


© Copy a file and delete specified records from it 


© Print all or part of a disk file whether it is being copied 5. 


to another disk file or not 


© Print selected records from a disk file based on either 


the relative record number or a key value 6. 


Note: For the Model 15, D3 and D4 can also be specified. 
The additional functions provided are: 


®@ Copy a file to or from magnetic tape 
© Copy a sequential file to an indexed file 


© Copy a file to or from cards 


© Copy a pack from R1 to R1 with work space on a 5445 8. 


© Copy part of a file to or from tape, disk, or cards 


The control statements and parameters required for this 
utility program to function are shown in Figure 10. A 
complete summary and explanation of the control state- 
ments and their parameters is contained in the /BM System/3 


The COPYPACK statement indicates that the content 
of one disk pack is to be transferred to another. The 
FROM parameter identifies the location of the disk 
pack being copied. The TO parameter identifies the 
location of the disk pack receiving the data. The 
FROM disk pack is copied track for track except for 
the pack 1D, the alternate track information, and 


error logging information. The two drives specified 
must be either both i 


The optional PACKIN parameter identifies the disk 


to be copied. This parameter is provided to check the 


pack ID to verify that the correct pack is mounted. 


The optional PACKO parameter identifies the output 
disk. This parameter is provided to check the pack 
ID to verify that the correct pack is mounted. 


The optional WORK parameter indicates where the 
work area is located, if a pack is copied from R11 to 
Ri. This parameter is not supported on the Model 10. 


The COPYFILE statement indicates that one file is 
to be copied to another location. Its parameters 
specify the type of copy performed. 


The OUTPUT and OUTPTX parameters indicate that 
the file is to be copied, printed, or both. When the 
disks are being copied, the FROM and TO files are 
specified as COPYIN and COPYO respectively. The 
OUTPTX parameter causes the output to be printed 
in hexadecimal values. 


The optional DELETE and OMIT parameters identify 
records for deletion from the file by giving the 
identifying character and its position in the record. 
Position (p) is the position of the character in the 
records. The position specified must be less than the 
record length. Character (c) is the character that 
identifies the records. If the DELETE parameter is 
used, the deleted records are printed. If the OMIT 





Model 10 Disk System Control Programming Reference 
Manual, GC21-7512 and the /BM System/3 Model 15 
System Control Programming Reference Manual, GC21- 
5077. The following numbered list corresponds to the 


numbered items in the figure. 9. 


1. These FILE statements identify the input and output 
files. The FILE statement COPYIN is required for all 
COPYFILE jobs. The FILE statement COPYO is 
only required if the output option on the COPY FILE 
statement is DISK, FILE or BOTH. The FILE state- 
ment COPYP is used to print on the 3284 printer 
(Model 15 only). FILE statements are not required 
for a COPYPACK run. 


16 


parameter is used, the deleted records are not printed. 
If neither parameter is used, all of the records in the 
input file are copied. 


The optional REORG parameter permits reorganiza- 
tion of the file as it is being copied. The YES option 
applies only to indexed files. If the YES option is 
specified, the output file is reorganized putting the 
records in ascending order by their key fields. If the 
NO option is specified, or if the entry is not included, 
either the file is not an indexed file or the records in 
the output file have the same sequence as in the input 
file. In either case, the input file is not affected. 


10. The optional WORK parameter indicates whether or 
not to use a work area. The assumption is NO if the 

) parameter is omitted. If YES is specified, the COPYIN 

file and the COPYO file are on different packs that 

are to be mounted on the same drive, either drive R1 

or D1 only. 


11. The optional SELECT statement controls the printed 
output. If the SELECT statement is not specified, 
and if the OUTPUT parameter on the COPYFILE 
statement is PRINT or BOTH, all the records are 


printed. On the Model 15, a selected portion of the 13. 


input (COPYIN) file is copied to the output (COPYO) 
file by coding FILE-YES. 


12. The RECORD parameters use relative record numbers 
to identify the records to be printed or copied. Rela- 
tive record numbers identify a record's location in 
the file with respect to other records in the file. The 
FROM parameter specifies the first record to be 
printed or copied. The TO parameter indicates the 
last relative record number to be printed or copied. 
The program assumes that the number of the last 


record in the file is the TO number if the TO param- 14. 


eter is omitted. 


R1 
// LOAD $COPY, FI 
R2 


F2 
//FILE | NAME-COPYIN 
// FILE | NAME-COPYO 
//FILE = NAME-COPYP 


// RUN 


The KEY and PKY parameters apply to printing or 
copying part of an indexed file. The FROM param- 
eter gives the key of the first record to be printed or 
copied. The TO parameter gives the key of the last 
record to be printed or copied. The program assumes 
that the last key in the index is the TO key if the 

TO parameter is omitted. The records printed or 
copied are those which have keys between or equal 
to the FROM and TO limits. The PKY parameter 
applies to an indexed file containing packed keys. 


The optional FILE parameter allows only selected 
records to be copied to a disk or tape as well as to a 
printer. If FILE-YES is specified, selected records 
are copied to the files named in the COPYO FILE 
statement. OUTPUT-BOTH or OUTPUT-PRINT 
must be specified if FILE-NO is specified. If OUTPUT- 
BOTH is specified, selected records are printed and 
the entire file is copied to the file named in the 
COPYO FILE statement. If OUTPUT-PRINT is 
specified, selected records are printed only. This 
parameter is not supported on the Model 10. 


The optional KEY statement is used to create an 
indexed disk file from a sequential file. LENGTH 
and LOCATION specify the key length and start 
location of the key in the record. 


FA 
R2 
// COPYPACK FROM— a 
D2 
D3 
D4 


HCOPYFILE J OUTPUT t _ 
OUTPTX 


R1 


F1 


Ri 
@ ® ©) 2 
To- {SF27\ | PACKINex...x] [PACKO-x...x] [WORK— 292\ | 
D1 D3 
D2 D4 
D3 


D4 


BOTH 
FILE 


OMIT 


DISK ® 
PRINT | ae ~‘pppp.c’] LREORG— { =} ] [WORK { oy 1 


RECORD,FROM-nnn[,TO-nnn] [FILE ven ] 
// SELECT KEY,FROM-’x...x'[,TO-’x...x’] NO 
PKY,FROM-'x...x'[,TO-’x...x'] 


I/KEY LENGTH>x...x,LOCATION-x...x 


// END 


) Figure 10. Specifications Required for the Copy/Dump Program 
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Dump/Restore Program 


By using the Dump/Restore program, you can copy the 
entire contents of a 5445 disk pack to magnetic tape for 
backup. The disk can, at any time, be restored to its 
original contents by transferring information back from 
the tape. 


The control statements and parameters required for this 
utility program to function are shown in Figure 11. The 
following numbered list corresponds to the numbered items 
in the figure. 


1. This FILE statement identifies the tape file used as 
a backup copy in case something happens to the 
information on the disk. The name of the tape must 
be BACKUP. 


2. The COPYPACK statement indicates that the contents 
of one disk pack are to be transferred to tape or are 
to be restored from tape. The FROM parameter 
indicates the location of the disk pack being copied. 
The TO parameter indicates the location of the disk 
pack receiving the copy. The PACK parameter indi- 
cates the name of the disk pack being used. 


// LOAD $DCOPY, 


// FILE NAME-BACKUP 


// RUN 


// COPYPACK J FO = LPACK-name] 
FROM 1 





Figure 11. Specifications Required for the Dump/Restore Program 
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RPG II 


RPG II can be used to process data files on the IBM 5445 
Disk Storage. 


RPG I! consists of a symbolic programming language and 
a compiler program. The source program statements are 
written by the programmer on special coding forms. 


The File Description Specifications define the control 
information and device entry for the 5445 to the RPG II 
compiler. Columns 40-46 of this form identify the input/ 
“output device for the file. The 5445 data files may be 
referenced by specifying DISK45 in those columns. For 
Model 15, device independent data management can be 
used. If device independent data management is used, the 
device name is left blank. At execution time, you can 
assign the files to a 5445. Other valid and consistent entries 
on the form have the same functional characteristics for the 
5445 files as are stated for 5444 files. . 


Only data files are supported for the 5445. The file organi- 
zations supported by RPG II are sequential, direct, and 
indexed. 


RPG II support operates under control of the IBM System/3 
Model 10 Disk System or Model 15 system control programs. 
The IBM System/3 Model 10 Disk RPG II (Program Number 
5702-RG1) is a prerequisite for the RPG || 5445 Disk 
Storage feature (Feature Numbers 6012/6014); Model 15 
RPG II (Program Number 5704-RG1) includes 5445 support. 


DISK SORT 


The input, output, and work files used with Disk Sort can 
be resident on the IBM 5445 Disk Storage. These files can 
be explained in relation to the Disk Sort program. 


The Disk Sort program is divided into two phases. The 
generation phase reads the sequence specifications into 

main storage and uses the information to generate an object 
program called the select/build routine. The execution phase 
uses this routine to select records from an input file to 
format work records on the work file, and to create a sorted 
output file. 


Chapter 3. Program Product Support 


The sequence specifications read by the generation phase 
identify the job and records for the Disk Sort program. 

The three types of sequence specifications are the header, 
the record type, and the field specifications. An explanation 
of these specifications, used on special coding sheets, is 
contained in /BM System/3 Disk Sort Reference Manual, 
$C21-7522. 


During the sorting process, the Disk Sort program requires 
three files: input, output, and work. The input file contains 
the records to be sorted. The output file contains the sorted 
file. The work file is an area on disk which is set aside as a 
work area. If the work file is a multivolume file, all of the 
files must be online. The location of these three files is 
described on the OCL FILE statement. The parameters 

for the FILE statement are described in Chapter 2 of this 
manual. The location of the work file can also be determined 
automatically. For the Model 15, directed 5445 automatic 
work file allocation uses the // SWITCH statement to deter- 
mine the location of the work file. See the /BM System/3 
Disk Sort Reference Manual, SC21-7522, for how the 

// SWITCH statement is used. 


The Disk Sort program creates three types of files. These 
types are the sorted sequential file (tag-along sort), the 
sorted record address file (addrout sort), and the summary 
tag-along sort file. The sorted files may be single or multi- 
volume disk files. They are kept on disk and may be used 
later by other programs. 


The Disk Sort program operates under control of the IBM 
System/3 Model 10 Disk System or Model 15 system control 
programs. The IBM System/3 Model 10 Disk Sort program 
(Program Number 5702-SM1) is a prerequisite for the Disk 
Sort 5445 Disk Storage feature (Feature Numbers 6008/ 
6010). The Model 15 Disk Sort program (Program Number 
5704-SM1) includes 5445 support. 
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SUBSET ANS COBOL 


By using the Subset ANS COBOL Compiler and Library 
program product, you can process data files on the 5445. 
COBOL language characteristics are the same for 5445 
files as for 5444 files. You identify the 5445 via the 
ASSIGN clause. The file organizations supported for 
COBOL are sequential, indexed, and direct. 


For Model 15, work files for the compiler can reside on the 
5445, 


Subset ANS COBOL for the Model 10 Disk System (Program 
Number 5702-CB1) operates under control of the IBM 
System/3 Model 10 system control programs. The Model 15 
COBOL (Program Number 5704-CB1) operates under con- 


trol of the 1BM System/3 Model 15 system control programs. 


FORTRAN IV 


The FORTRAN IV program is another IBM program product 
that supports the 5445. Support for the 5445 is function- 
ally identical to that provided for the 5444. 


For Model 15, work files for the compiler can reside on the 
5445. 


FORTRAN IV for the Model 10 Disk System (Program 
Number 5702-FO1) operates under control of the IBM 
System/3 Model 10 Disk system control programs. On 

the Model 15, FORTRAN IV (Program Number 5704-FO1) 
operates under control of the IBM System/3 Model 15 
system control programs. | 


MAGNETIC CHARACTER READER UTILITY PROGRAM 
(Model 10 Only) 


The IBM System/3 Model 10 Disk System 1255 Magnetic 
Character Reader Utility program (Program Number 5702- 
UT2) supports the IBM 5445 Disk Storage by making pos- 
sible the same functions it makes possible for the 5444. 
Chapter 2 of this manual contains the OCL considerations 
for 5445 support. No change in coding is required in the 
1255 utility program specifications. This program is avail- 
able only for the Model 10. (For the Model 15, an SCP 
subroutine is available for use with RPG I! or assembler ob- 
ject programs to support the 1255. 
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BASIC ASSEMBLER 


By using the Mode! 10 and Model 15 Basic Assembler, you 
can write assembler language programs that support the 
5445. 


System macro instructions are available with the SCP to 
simplify coding required by the assembler. Macros perform 
the following functions for the 5445: 


© Build a preopen DTF for disk GET and PUT operations 
and assign its offsets 


© Build an input/output block (IOB) for disk read/write 
operations and assign its offsets 


© Build the interfaces required to get input records from a 
disk device via a GET or a READ operation 


© Build the interfaces required to put output records to a 
disk device via a PUT or a WRITE operation 


See the /BM System/3 Model 10 Disk System Control 
Programming Macros Reference Manual, GC21-7562, or 
the /BM System/3 Model 15 System Control Programming 
Macros Reference Manual, GC21-7608. 


Disk files created on the 5445 can be read and updated 
using a System/360-System/370. Conversely disk files 
can be created using a System/360-System/370 and sub- 
sequently read or updated with the System/3 Model 10 
Disk System or Model 15. However, the System/360- 
System/370 program used to create the disk file must be 
written at the EXCP level. 


The volume label and VTOC identify the information con- 
tained on the 5445 disk pack. The volume label identifies 
the volume and points to the System/360-System/370 
VTOC. The System/360-System/370 VTOC contains one 
label record which describes the complete pack as one 
System/360-System/370 file. The System/3 VTOC resides 
in a fixed location within this System/360-System/370 file 
and can be examined by the System/360-System/370 pro- 
gram. 


SYSTEM/3 TO SYSTEM/360-SYSTEM/370 


The System/3 Disk Initialization program writes a volume 
label in the System/360-System/370 format on every disk 
pack. The System/3 disk format consists of 256-byte 
physical records. This record length may be altered for 
System/360-System/370 VTOC records. 


Chapter 4. Compatibility 


When creating a file to be used by System/360-System/370, 
System/3 may use any of the access methods previously 
listed. The logical records in a particular System/3 file 

can be accessed by System/360-System/370 by means of 

a user program using the sequential access method if the 
user program: 


© Locates the file label in the System/3 VTOC for the 
desired file 


© Uses the start of data information and record length 
information from the System/3 VTOC to perform the 
accessing and logical deblocking 


© Uses the end-of-file information from the System/3 VTOC 


SYSTEM/360-SYSTEM/370 TO SYSTEM/3 


Volumes created on System/360-System/370 can be pro- 
cessed on System/3 if System/360-System/370 provides a 
System/3 VTOC entry and writes 256-byte physical records, 
in which case a System/3 user program or utility can then read 
and unblock the file according to the information in the 
System/360-System/370 file label. 
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